home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Best of Shareware
/
Best of PC Windows Shareware 1.0 - Wayzata Technology (7111) (1993).iso
/
mac
/
ZIPPED
/
DOS
/
UTILITY
/
MENU_124.ZIP
/
MENU-MAN.DOC
< prev
next >
Wrap
Text File
|
1992-07-31
|
46KB
|
1,325 lines
Ç ────────────────────────────────────────────
Ç ┼┐════════════════════════════════════════════
╔╬╗ ┴
╨║╨ ┐
╔╩╗ ┴
╨ ╨
▒▒▄ ▒▒▄▒▒▒▒▒▒▒▒▄▒▒▄ ▒▒▄▒▒▄ ▒▒▄ ▒▒▄ ▒▒▄ ▒▒▄ ▒▒▄ ▒▒▄
▒▒▒▄ ▒▒▒█▒▒█▀▀▀▀▀▀▒▒▒▄ ▒▒█▒▒█ ▒▒█ ▒▒▒▄ ▒▒▒█ ▒▒▒▒▄ ▒▒▒▄ ▒▒█
▒▒▒█ ▒▒▒█▒▒▒▒▒▒▒▒▄▒▒█▒▒▄▒▒█▒▒█ ▒▒█ ▒▒▒█ ▒▒▒█ ▒▒█▀▒▒▄ ▒▒█▒▒▄▒▒█
▒▒█▒▒▄▒▒█▒▒█▀▀▀▀▀▀▒▒█ ▀▒▒▒█▒▒█ ▒▒█ ▒▒█▒▒▄▒▒█ ▒▒▒▒▒▒█ ▒▒█ ▀▒▒▒█
▒▒█▒▒█▒▒█▒▒▒▒▒▒▒▒▄▒▒█ ▒▒█▒▒▒▒▒▒▒▒█ ▒▒█▒▒█▒▒█▒▒█▀▀▀▒▒▄▒▒█ ▒▒█
▀▀ ▀▀ ▀▀ ▀▀▀▀▀▀▀▀ ▀▀ ▀▀ ▀▀▀▀▀▀▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀
Welcome to MENU-MAN, a utility routine to display custom user selection menus
from batch files!
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
U S E R M A N U A L
Version 1.2
Release April 26, 1991
▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
Copyright 1990-1992 by Micrometric.
All rights reserved.
MENU-MAN is distributed as SHAREWARE and, as such, may be copied and shared on a
private non-commercial basis with others in its unmodified form. Liability is
limited to replacing the software for registered users. There is no liability
for any damage or loss caused by this software, directly or indirectly.
┌────────────────────────────────────────────────┐
│ ┌───────┐ │█
│ ┌────┴──┐ │ (R) │█
│ ──│ │O │─────────────────── │█
│ │ ┌────┴╨─┐ │ Association of │█
│ │ │ │─┘ Shareware │█
│ └──│ O │ Professionals │█
│ ─────│ ║ │───────────────────── │█
│ └───╨───┘ MEMBER │█
└────────────────────────────────────────────────┘█
██████████████████████████████████████████████████
If you have problems with this program, or want to send comments, manual correc-
tions, or enhancement suggestions, you may call or mail them to:
Micrometric
98 Dade Avenue
Sarasota, FLorida 34232-1609 USA
Tech Support . . . (813) 377-2515
FAX . . . . . . . (813) 377-2091
Support BBS . . . (813) 371-2490
The Micrometric Software Support BBS provides availability and technical support
for the Micrometric ■■■■-MAN series of shareware programs. First time callers
have access to the board and can leave messages or download replies/current
shareware releases. Registered users may also download the latest Beta test
software releases, when available.
Additionally, you can send routed E-Mail via the RIME(tm) network to David
Groome at the ->ACTION node in the ASP, Laser, Batch, Common, or Shareware con-
ferences. I also check CompuServe (71631,744), but only on an infrequent basis.
PKZIP, PKUNZIP and PKSFX are trademarks of PKWARE, Inc.
MS-DOS is a registered trademark of the Microsoft Corporation.
IBM PC, XT, AT and PC-DOS are registered trademarks of the IBM Corporation.
2
TABLE OF CONTENTS
INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Major Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Manual Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Page layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Brackets and parentheses . . . . . . . . . . . . . . . . . . . . . . 6
Computer key conventions . . . . . . . . . . . . . . . . . . . . . . 6
Action steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
■■■■-MAN programs . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Shareware distributed documentation manual . . . . . . . . . . . . . 6
Shareware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
INSTALLING THE SYSTEM . . . . . . . . . . . . . . . . . . . . . . . . . . 9
From a Diskette Vendor . . . . . . . . . . . . . . . . . . . . . . . . . 9
From a BBS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Registered Version . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
RUNNING MENU-MAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Identifier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Batch-file-name . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Title-line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Selection-X-line . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
MENU-MAN OPTIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Display Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Exploding Window Time . . . . . . . . . . . . . . . . . . . . . . . . . 17
Sound . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Menu Position . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Menu Colors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Menu Highlight Location . . . . . . . . . . . . . . . . . . . . . . . . 20
Display Text Only . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Shadow Border . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Erase Before . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Erase After . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
MENU-MAN OPERATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
ERRORLEVEL Testing . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
EXAMPLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Shareware message . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
3
TABLE OF CONTENTS MENU-MAN Version 1.2
4
INTRODUCTION
MENU-MAN allows the display of user selection menus from within batch files.
These menus are controlled by command line options and can contain a title and
up to twenty-three selection option lines that are generated from REM lines in
the batch which follow the call to MENU-MAN. Options include a user response
time limit, menu positioning, erasing the screen before/after menu display, and
menu sound, color and type customization.
Major Features
* Over 200 different menus per batch file.
* Simple format: MENU-MAN # filename options
REM TITLE
REM USER SELECTION 1
REM USER SELECTION 2
REM ...
* User defined window selection menus embedded in batch files.
* Automatic color display on systems so equipped.
* User control over most window menu parameters on a per menu basis.
* Display selection menus or informational messages.
* MENU-MAN sets the ERRORLEVEL environment variable for easy user selection
testing in the batch file.
* User selections are imbedded in the batch file, not separated into another
file.
* Menu may be displayed for a limited time to aid in uses such as AUTOEXEC for
unattended operation.
* A sound may be made when the window is displayed. The pitch and duration of
the sound is adjustable.
* The menu colors are adjustable.
* The screen may be erased before the menu is displayed or the menu can overlay
the current screen display.
* The menu may be erased after user selection or left.
* The position of the menu - Up, center, down and left, center, right - may be
specified.
System Requirements
MENU-MAN will run on an IBM PC, XT, AT or true compatibles. It has been tested
with PC-DOS/MS-DOS operating systems, version 3.0 through version 5.0. The pro-
gram will determine what type of display monitor is available and adjust itself
accordingly.
Manual Format
This manual is divided into several introductory chapters followed by chapters
for operating MENU-MAN. The format of these chapters and the information pre-
sented therein has been standardized using the following conventions.
Page layout - Each page has a header detailing the chapter and the program ver-
sion covered. A footer displays the manual page number.
5
INTRODUCTION MENU-MAN Version 1.2
Brackets and parentheses - Brackets, [...], are used in the manual to specify
what should be entered in response to the current prompt. If a character string
is to be entered, the type of character is noted, such as ALPHA, NUMERIC, ANY,
etc. Parentheses, (..), are used for comments.
Computer key conventions - Keys specified in the manual text that are not in
entry brackets are shown as reversed, such as ESCAPE . All key references are
in capital letters for clarity.
Action steps - Some procedures may require selection from a menu of options,
inputting data or following a sequence of steps. Most manual sections will first
give an overview of the function or task under discussion and then detail the
various action operating procedures. In order to make this manual easier to use
a symbol, -> , marks the beginning of each of these action operating procedures.
■■■■-MAN programs - The general group of shareware programs by Micrometric is
referred to by the name ■■■■-MAN. It may also be used in reference to a specific
program in that group.
Shareware distributed documentation manual - The documentation file included on
the shareware distribution diskette contains the same information as the printed
and bound manual, supplied as part of registration, with two exceptions, the
result of the word processor, formatting, and printer used. The first is that
all of the control display characters (ASCII 1-31) and the reverse print key-
board codes are NOT shown properly. Finally, bolding, underlining, and special
symbols are NOT present.
Shareware
MENU-MAN is being distributed as SHAREWARE. The SHAREWARE concept allows users
to examine a program on a trial basis at no (or minimal) charge before purchas-
ing it. In addition, by decreasing marketing costs, professional quality soft-
ware may be distributed for a fraction of the cost of a comparable commercial
product. Regardless of whether you register the program, please help distribute
MENU-MAN by sharing unmodified copies of it and its files with others.
You are hereby granted the right to use the MENU-MAN program for a thirty (30)
day evaluation period. If you find MENU-MAN of value and continue to use it
after this evaluation period, YOU MUST REGISTER YOUR PROGRAM USE. This will
provide you with:
* A 7" x 8 1/2" printed and bound manual.
* MENU-MAN phone or mail support for one year.
* Notification of the next MENU-MAN release.
* Ability to suppress the shareware registration reminder message displayed
at the end of the program.
* An installation/update/registration brand program.
* Sincere thanks for your support of the SHAREWARE concept.
A Single System Program Registration entitles the user to unlimited use of the
MENU-MAN program on a single computer.
6
MENU-MAN Version 1.2 INTRODUCTION
A Site License Program Registration entitles the user to unlimited use of the
MENU-MAN program on all computers, including networks, at a single corporate
location.
Program Registration, Single System . . . $20.
Includes latest version diskette and manual
Program Registration, Site License . . . $200.
Includes latest version diskette and manual
Latest Version Diskette only . . . . . . $10.
Shipping - Surface (for outside of USA/Canada only)$5.
Shipping - Air (for outside of USA/Canada only)$10.
COD and credit card orders, add 5%
Florida residents, add 7% sales tax
ADDRESS: Micrometric
98 Dade Avenue
Sarasota, FLorida 34232-1609 USA
PHONE: Tech Support . . (813) 377-2515
FAX . . . . . . . (813) 377-2091
Support BBS . . . (813) 371-2490
Order Line . . . (800) 929-0184
For ease in program registration, a registration order form is included with the
distribution files.
This program is produced by a member of the Association of Shareware Profession-
als (ASP). ASP wants to make sure that the shareware principal works for you. If
you are unable to resolve a shareware-related problem with an ASP member by
contacting the member directly, ASP may be able to help. The ASP Ombudsman can
help you resolve a dispute or problem with an ASP member, but does not provide
technical support for members' products. Please write to the ASP Ombudsman at
545 Grover Road, Muskegon, MI 49442-9427, send a CompuServe message via easyplex
to ASP Ombudsman 70007,3536, or by FAX to the ASP FAX number: (616) 788-2765. In
communications with the Ombudsman please include a telephone number and/or FAX
if available.
7
INTRODUCTION MENU-MAN Version 1.2
8
INSTALLING THE SYSTEM
From a Diskette Vendor
If the MENU-MAN program has been obtained from a diskette vendor, you should
follow any of their instruction on unpacking/installing the programs (if indeed
they have separate instructions.) The program, and its files, is normally sup-
plied as a self extracting file whose name is "MENU@xxx.EXE" (xxx is the ver-
sion, such as "MENU@100").
This file should first be copied to a directory on your hard disk. This direc-
tory may be a new one, such as one named "MENU", and created specifically for
MENU-MAN, or a current one, such as "UTILITY", that has other programs/files.
For information on creating a separate directory, see your DOS manual.
NOTE FOR BEST OPERATION, ALL REQUIRED MENU-MAN FILES *SHOULD* BE PLACED ON
PATH REFERENCED SUBDIRECTORIES!
Once the file is copied to the desired hard disk directory, at the DOS prompt
change to this drive directory, and then type the EXE file name (such as
"MENU@100") and press ENTER . This will unpack all of the MENU-MAN files.
From a BBS
If the MENU-MAN file was downloaded from a Bulletin Board, it should first be
copied to a directory as defined above, and then unpacked, using whatever pro-
gram is specified by the Bulletin Board. It is normally distributed with a name
of "MENU@vvv.ZIP" (vvv is the version) or "MENUMN.ZIP".
Registered Version
Registered users should use the program "INSTALL", that is supplied upon regis-
tration. This program will create a registration file which will, in turn, sup-
press the shareware registration reminders.
-> To install MENU-MAN on your hard disk, follow the steps detailed below:
1. Place the MENU-MAN distribution diskette in your floppy diskette drive.
2. At the DOS prompt, change to the drive in which the distribution diskette
is located. For example, if the diskette was placed in drive A, type A
: and press ENTER .
3. Type I N S T A L L and press ENTER . The installation pro-
gram will then be loaded, and its display should be as shown below.
9
INSTALLING THE SYSTEM MENU-MAN Version 1.2
╒═╡ INSTallation MANagement Program/One System Started at═>07-31-92 03:00 ╞═╕
│░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
│░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
│░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
│░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
│░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
│░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
│░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
│░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
│░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
│░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
│░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
│░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
│░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
│░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
│░ ░░▄ ░░▄ ░░▄░░░░░░░░▄░░░░░░░░▄ ░░▄ ░░▄ ░░▄ ░░▄ ░░▄░│
│░ Ç═ ░░█ ░░░▄ ░░█░░█▀▀▀▀▀▀ ▀▀░░█▀▀▀ ░░▄ ░░░▄ ░░░█ ░░░░▄ ░░░▄ ░░█░│
│░ ┌┼┐ ░░█ ░░█░░▄░░█░░░░░░░░▄ ░░█ ░░░█ ░░░█ ░░░█ ░░█▀░░▄ ░░█░░▄░░█░│
│░ ┌┴┐ ░░█ ░░█ ▀░░░█ ▀▀▀▀▀░░█ ░░█ ░░█ ░░█░░▄░░█ ░░░░░░█ ░░█ ▀░░░█░│
│░═┴═┴═░░█ ░░█ ░░█░░░░░░░░█ ░░█ ░░░░▄ ░░█░░█░░█░░█▀▀▀░░▄░░█ ░░█░│
│░ ▀▀ ▀▀ ▀▀ ▀▀▀▀▀▀▀▀ ▀▀ ▀▀▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀░│
╘╡ INSTALL/1 Version 3.00 Copyright 1990-92 Micrometric, All Rights Reserved ╞╛
F1>Help│ESC>Exit│ENTER/[char]>Select│ HomeEnd│
NOTE Context sensitive help is available from this point in the installa-
tion program on, by pressing the F1 key.
4. If a color video card is detected, the following prompt will be displayed.
┌──────────────────────────────────────┐
│ ╔═╡ Color Monitor Card Detected ╞═╗ │
│ ║ Use the color display ║█ │
│ ║ Force a monochrome display ║█ │
│ ╚═════════════════════════════════╝█ │
│ ███████████████████████████████████ │
└──────────────────────────────────────┘
-> If your system has a color monitor, press U .
-> If your system has a monochrome or LCD display, press F .
5. A selection list of all path referenced directories is next displayed.
NOTE FOR BEST OPERATION, ALL REQUIRED MENU-MAN FILES *SHOULD* BE PLACED
ON PATH REFERENCED SUBDIRECTORIES!
10
MENU-MAN Version 1.2 INSTALLING THE SYSTEM
┌────────────────────────────────────────────┐
│ ┌─┤ Select the INSTALLATION DIRECTORY ├─┐ │
│ │ C:\BAT │█ │
│ │ C:\DOS-500 │█ │
│ │ C:\UTILITY │█ │
│ │ C:\ZIP │█ │
│ │ C:\ │█ │
│ │ User Defined Drive-Directory Path │█ │
│ └───────────────────────────────────────┘█ │
│ █████████████████████████████████████████ │
└────────────────────────────────────────────┘
-> To cancel the installation program at this point, press ESCAPE .
-> To select one of the path referenced directories on which to install
MENU-MAN, move the highlight bar to the desired one and press ENTER .
-> To specify a non-path referenced directory on which to install
MENU-MAN, press U and then press ENTER . A data entry window for the
installation path will then be displayed, as shown below (with an exam-
ple path already entered). Enter the desired drive and directory path
on which to install MENU-MAN, using the control keys described on the
bottom help line.
┌────────────────────────────────────────────────────────────────────────┐
│ ┌─┤ Enter Path ├────────────────────────────────────────────────────┐ │
│ │ C:\MENU.......................................................... │█ │
│ └───────────────────────────────────────────────────────────────────┘█ │
│ █████████████████████████████████████████████████████████████████████ │
└────────────────────────────────────────────────────────────────────────┘
-> To cancel defining the path, press ESCAPE . The program will return
to directory selection.
-> To accept the path as entered and edited, press ENTER . If the
specified directory does not currently exist, the following message
will be displayed.
┌────────────────────────────────────────────────────────────────────┐
│ ┌─┤ MESSAGE ├───────────────────────────────────────────────────┐ │
│ │ The drive-directory path as entered DOES NOT currently exist. │█ │
│ │ This directory WILL NOW BE created. │█ │
│ └───────────────────────────────────────────────────────────────┘█ │
│ █████████████████████████████████████████████████████████████████ │
└────────────────────────────────────────────────────────────────────┘
-> To cancel creation of this directory, press ESCAPE .
-> To create the specified directory, press ENTER . If the speci-
fied drive is invalid or the requested installation directory's
parent does not exist, an error message will be displayed. Press
any key, and then re-edit the installation path.
6. If more than one system is available for installation, a SYSTEM TO INSTALL
selection menu will be displayed, as shown below.
11
INSTALLING THE SYSTEM MENU-MAN Version 1.2
┌─────────────────────────────────────────────────────────────────────┐
│ ╔═══╡ Select the SYSTEM TO INSTALL ╞═════════════════════════════╗ │
│ ║ ENVI-MAN Environment data summary, environ. space remaining ║█ │
│ ║ FILE-MAN Menu driven DOS file manager, directory tree ║█ │
│ ║ LASR-MAN Print text files on a laser printer, 36 print styles ║█ │
│ ║ MENU-MAN Display custom user selection menus from batch files ║█ │
│ ║ PATH-MAN Determines if a file is on a PATH directory ║█ │
│ ╚════════════════════════════════════════════════════════════════╝█ │
│ ██████████████████████████████████████████████████████████████████ │
└─────────────────────────────────────────────────────────────────────┘
-> To terminate the installation program at this point, press ESCAPE .
-> To select the SYSTEM TO INSTALL, press its highlighted letter or move
the highlight bar to in with the arrow keys and press ENTER .
7. A list of all MENU-MAN files is next displayed, along with an INSTALLATION
FUNCTION menu. The normal sequence of operations is to first "Install" the
MENU-MAN program and files, and then "Brand" the system with your name and
serial number.
┌─────────────────────────────────────────────────────────────┐
│ ╒═╡ Select the INSTALLATION FUNCTION ╞═══════════════════╕ │
│ │ Install system Brand system eXit │█ │
│ ╘════════════════════════════════════════════════════════╛█ │
│ ██████████████████████████████████████████████████████████ │
└─────────────────────────────────────────────────────────────┘
┌──────────────────────────────────────────────────────────────────────────────┐
│╒═╡ File Name Status Hard Disk Path/File Description MENU-MAN FILES ╞═╕ │
││ System═>MENU-MAN Display custom user selection menus from batch files│█│
││ MENU-MAN.EXE PROCESS Utility program │█│
││ YYYY.YYY PROCESS Other files │█│
│╘═╡ INSTALLATION PATH═>C:\MENU ╞════════════════════════════════════════════╛█│
│ █████████████████████████████████████████████████████████████████████████████│
└──────────────────────────────────────────────────────────────────────────────┘
-> To install MENU-MAN on the hard disk, insure that the highlight bar is
on the "INSTALL SYSTEM" FUNCTION and press ENTER . Each of the file(s)
will be copied to the selected installation drive-directory.
NOTE A happy face symbol after any of the system's file names de-
notes that this file is already on the hard disk. During in-
stallation it will be replaced, on the directory where it
currently resides, not the INSTALLATION DRIVE-DIRECTORY PATH.
When all files have been copied to the hard disk, a copy complete mes-
sage is displayed.
12
MENU-MAN Version 1.2 INSTALLING THE SYSTEM
┌───────────────────────────────────────────────────────────────┐
│ ┌─┤ MESSAGE ├──────────────────────────────────────────────┐ │
│ │ FILE COPY COMPLETED. │█ │
│ │ All of the required BOOK-IT! files are on the hard disk. │█ │
│ │ ═══> BOOK-IT! IS READY TO RUN. <═══ │█ │
│ └──────────────────────────────────────────────────────────┘█ │
│ ████████████████████████████████████████████████████████████ │
└───────────────────────────────────────────────────────────────┘
-> To cancel the installation at this point, press ESCAPE .
-> To continue with the installation, press any other key. The high-
light bar will then be on the "BRAND SYSTEM" FUNCTION.
8. -> To brand the system with your name and serial number, move the high-
light bar to the "BRAND SYSTEM" FUNCTION and press ENTER . A REGISTRA-
TION INFORMATION data entry window will be displayed, as shown below,
with sample data already entered.
NOTE This step is REQUIRED for MENU-MAN to be registered. Also, if
you move the MENU-MAN files to another drive-directory you
will need to "BRAND" the system again.
Enter your company and/or your name, and then the system registration
number. Your registration number is located on the back of the front
cover of this manual.
┌──────────────────────────────────────────┐
│ ┌─┤ REGISTRATION INFORMATION ├────────┐ │
│ │ Name ABC COMPANY, George Jones │█ │
│ │ Registration number 12345678 │█ │
│ └─────────────────────────────────────┘█ │
│ ███████████████████████████████████████ │
└──────────────────────────────────────────┘
-> To accept either the name or registration number after entry and
editing, press ENTER . A message will be displayed after the regis-
tration number is entered. It's contents are dependent on whether
the registration number is valid. Both messages are shown below.
┌───────────────────────────────────────────────┐
│ ┌─┤ MESSAGE ├──────────────────────────────┐ │
│ │ BOOK-IT! serial number entered is VALID. │█ │
│ └──────────────────────────────────────────┘█ │
│ ████████████████████████████████████████████ │
└───────────────────────────────────────────────┘
┌─────────────────────────────────────────────────┐
│ ┌─┤ MESSAGE ├────────────────────────────────┐ │
│ │ BOOK-IT! serial number entered is INVALID! │█ │
│ │ Please try again. │█ │
│ └────────────────────────────────────────────┘█ │
│ ██████████████████████████████████████████████ │
└─────────────────────────────────────────────────┘
13
INSTALLING THE SYSTEM MENU-MAN Version 1.2
-> To continue with the installation program, press any key. If the
registration number was valid, the "EXIT" option is highlighted.
If it was invalid, select the "BRAND SYSTEM" option again.
9. -> To exit from the installation program, move the highlight bar to the
"EXIT" FUNCTION and press ENTER . If the system has been properly
branded, the program will exit, and MENU-MAN is ready for use. If the
system has not been branded, an error message is displayed, as shown
below.
┌─────────────────────────────────────────────────────────────────┐
│ ┌─┤ MESSAGE ├────────────────────────────────────────────────┐ │
│ │ This system has not been 'BRANDED'. │█ │
│ │ In order to be registered, it must first be 'BRANDED'! │█ │
│ │ To exit without BRANDING, press ESCAPE. │█ │
│ │ To continue with the INSTALL program, press any other key. │█ │
│ └────────────────────────────────────────────────────────────┘█ │
│ ██████████████████████████████████████████████████████████████ │
└─────────────────────────────────────────────────────────────────┘
14
RUNNING MENU-MAN
The syntax to execute the MENU-MAN utility program from a batch file is:
...
MENU-MAN identifier batch-file-name [option a] [option b] [...]
REM title-line
REM selection-1-line
REM selection-2-line
...
(BATCH FILE LINE THAT DOES NOT START "REM...")
...
The program name and all command line parameters must be separated by at least
one space. If no parameters are present, a MENU-MAN syntax summary will be dis-
played.
Identifier
identifier is a unique character used to identify the location in the batch-
file-name batch file from where this call was made. MENU-MAN searches this batch
file for a line with its name (MENU-MAN) and this identifier. The title and the
user selection options are then taken from following REM statements.
Batch-file-name
batch-file-name is the name of the batch file which this statement is in. The
easiest was to specify this parameter is to use the batch file variable %0, to
which DOS assigns the batch file name. MENU-MAN adds the extension .BAT if it is
not present, and will first search the current drive/directory for this name. If
it is not found, MENU-MAN will then search each drive/directory in the PATH
statement in turn. If no match is found, an error message is displayed and
MENU-MAN returns control to the batch file that called it.
If your batch file changes the current drive/directory to one that is not in the
PATH before it executes MENU-MAN , you must specify the full path
drive/directory along with the batch-file-name on the command line.
Options
options may be specified after the first two required parameters and may appear
in any order. The individual options are covered in the next section.
Title-line
Following the MENU-MAN command line should be a batch file REM statement. The
contents of this statement will be used as the title of the displayed menu.
15
RUNNING MENU-MAN MENU-MAN Version 1.2
Selection-X-line
Following the REM title statement should be a set of batch file REM statements
that are the desired selection options for this menu. Each REM will be displayed
on a separate menu line in the order that they appear in the batch file. The
first numeric or capitalized alpha character that has not been highlighted on
previous menu lines will be highlighted on this menu line and may be used for
user selection. Up to twenty-three menu lines may be specified. MENU-MAN will
scan for REM menu lines until the maximum number is reached or a non REM state-
ment line encountered in the batch file.
16
MENU-MAN OPTIONS
The MENU-MAN options allow customizing the individual menus. None of these op-
tions are required: MENU-MAN will produce selection menus without any options
being specified. Options may be specified as either upper or lower case letters.
Display Time
The selection menu is normally displayed with a bottom border line of "Please
Enter Choice!". For use in batch file such as AUTOEXEC.BAT where you normally
want a default selection and the ability to run without user input, a display
time option may be used. When used, this option changes the bottom border line
to read "Selection Time Remaining #" where # is the number of seconds remaining
to make a choice. If no user choice is before the option time expires, MENU-MAN
returns to the batch file with ERRORLEVEL equal to zero.
The display time option is:
T#####
where: ##### is the number of seconds to wait for a user response and
may range from zero to 32,767.
EXAMPLE: An option of T12 will wait twelve seconds for a user selection.
Exploding Window Time
The selection menu is built in stages so as to give an "exploding" appearance.
Normally, there is no delay time between these stages. However, in order to
extend the "explosion", this option allows a time delay to be placed between the
stages. The default is 20 milliseconds.
The exploding window time option is:
W#####
where: ##### is the number of milliseconds to delay between building
stages of the window menu and may range from zero to
32,767.
EXAMPLE: An option of W200 will delay 200 milliseconds between stages in build-
ing the menu window.
17
MENU-MAN OPTIONS MENU-MAN Version 1.2
Sound
A short beep sound is made to get the users attention when the selection menu is
displayed. Both the pitch and the length of this sound may be changed. If either
value is set to zero, no sound will be produced when the menu is displayed.
The sound option is:
B#####,#####
where: the first ##### is the pitch in cycles per second and the
second is the length in milliseconds. These numbers may
range from zero to 32,767. The default values are a pitch
of 700 Hz and 200 milliseconds.
EXAMPLE: An option of B512,500 will sound a half second 512 HZ tone as the se-
lection menu is displayed.
Menu Position
The default selection menu position is the center of the screen. The menu posi-
tion option allows menus to be placed at other locations.
The menu position option is:
P{V},{H}
where: {V} is the vertical position code;
T - Top
C - Center
B - Bottom
{H} is the horizontal position code;
L - Left
C - Center
R - Right
EXAMPLE: An option of PT,R will display the selection menu in the upper right
corner of the screen.
18
MENU-MAN Version 1.2 MENU-MAN OPTIONS
Menu Colors
There are five areas of the selection menu that can have colors assigned to
them. These areas and their default colors are shown below.
┌──────────────────────────────────────────────────────────────────┐
│ AREA CODE FOREGROUND BACKGROUND VALUE │
├──────────────────────────────────────────────────────────────────┤
│ Non-highlighted test N Light grey Blue 28 │
│ Highlighted text H White Blue 31 │
│ Border B Yellow Blue 30 │
│ Title T Light cyan Blue 27 │
│ Shadow border S Light grey Black 7 │
│ Option highlight bar O White Red 79 │
└──────────────────────────────────────────────────────────────────┘
The color codes are shown in the table below. To have an area blink, add 128 to
the color code chosen.
┌────────────┬───────────────────────────────────────────────────────┐
│ │ - - - - B A C K G R O U N D - - - - │
│ │ │
│ FOREGROUND │ BLACK BLUE GREEN CYAN RED MAGENTA BROWN WHITE │
│ ├───────────────────────────────────────────────────────┤
│ BLACK │ 0 16 32 48 64 80 96 112 │
│ BLUE │ 1 17 33 49 65 81 97 113 │
│ GREEN │ 2 18 34 50 66 82 98 114 │
│ CYAN │ 3 19 35 51 67 83 99 115 │
│ │ │
│ RED │ 4 20 36 52 68 84 100 116 │
│ MAGENTA │ 5 21 37 53 69 85 101 117 │
│ BROWN │ 6 22 38 54 70 86 102 118 │
│ LIGHTGREY │ 7 23 39 55 71 87 103 119 │
│ │ │
│ DARKGREY │ 8 24 40 56 72 88 104 120 │
│ LIGHTBLUE │ 9 25 41 57 73 89 105 121 │
│ LIGHTGREEN │ 10 26 42 58 74 90 106 122 │
│ LIGHTCYAN │ 11 27 43 59 75 91 107 123 │
│ │ │
│ LIGHTRED │ 12 28 44 60 76 92 108 124 │
│ LIGHTMAGENTA 13 29 45 61 77 93 109 125 │
│ YELLOW │ 14 30 46 62 78 94 110 126 │
│ WHITE │ 15 31 47 63 79 95 111 127 │
└────────────┴───────────────────────────────────────────────────────┘
The color option is:
C@###
where: @ is the menu area code from the first table above (N, H, B, T
or S).
### is the color value from the second table above.
EXAMPLE: An option of CT113 will display the title in dark blue on a white back-
19
MENU-MAN OPTIONS MENU-MAN Version 1.2
ground.
Menu Highlight Location
The default menu highlight location is the first menu line. This option allows
the highlight to be initially located on any valid menu line when the menu is
displayed.
The menu highlight location option is:
L##
where: ## is the menu line to highlight.
EXAMPLE: An option of L8 will highlight the eight menu line.
Display Text Only
MENU-MAN normally displays a menu consisting of a title line and a variable
number of menu lines and then waits for the user to select a menu line. This
option allows the text and the menu lines to be displayed without requesting a
selection from the user.
The display text only option is:
M#####
where: ##### is the number of seconds to display the text and the
menu lines and may range from zero to 32,767.
EXAMPLE: An options M5 will display the menu title and text lines for five sec-
onds. There is no user selection required nor is there a countdown of
the display time left.
Shadow Border
The default menu display uses a shadow border as if a light was shining on the
raised menu from the upper left. This option removes this shadow.
The shadow border option is:
S-
EXAMPLE: An option of S- will not display a shadow border.
20
MENU-MAN Version 1.2 MENU-MAN OPTIONS
Erase Before
By default, the selection menu overlays the current screen display. This option
will first clear the screen before the selection menu is displayed.
The erase before option is:
EB
EXAMPLE: An option of EB will erase the screen before the selection menu dis-
play.
Erase After
By default, the selection menu is left on the screen display after the user
selection has been made. This option will remove the selection menu after a
choice has been made and the screen will be restored to what it was before the
menu was displayed. A line is then displayed showing the user choice that was
made.
The erase after option is:
EA
EXAMPLE: An option of EA will remove the user selection menu after a choice of
the third option line has been made and then display the following
line:
Your Choice was "option 3 menu line"!
21
MENU-MAN OPTIONS MENU-MAN Version 1.2
22
MENU-MAN OPERATION
After MENU-MAN has displayed the menu and accepted the users response, it will
exit and return to the batch file with the ERRORLEVEL parameter set to the num-
ber of the menu line selected by the user.
ERRORLEVEL Testing
To determine which selection the user has made, you must test the variable
ERRORLEVEL in the batch file. To determine if the user selected option four,
use:
if ERRORLEVEL 4 if NOT ERRORLEVEL 5 goto SELECT4
When using the display time option, to determine if the user made a choice (this
can be used as a default), use:
if ERRORLEVEL 0 if NOT ERRORLEVEL 1 goto NOCHOICE
EXAMPLE
This batch file segment will produce the selection menu show below -
...
MENU-MAN C %0
rem This line will be the Title
rem option 1 menu line
rem option 2 menu line
rem option 3 menu line
rem option 4 menu line
if ERRORLEVEL 1 if NOT ERRORLEVEL 2 goto SELECT1
if ERRORLEVEL 2 if NOT ERRORLEVEL 3 goto SELECT2
...
┌──────────────────────────────────┐
│ ╒═This line will be the Title═╕ │
│ │ option 1 menu line │█ │
│ │ option 2 menu line │█ │
│ │ option 3 menu line │█ │
│ │ option 4 menu line │█ │
│ ╘═══ Please Enter Choice! ════╛█ │
│ ███████████████████████████████ │
└──────────────────────────────────┘
Shareware message
A shareware message may be randomly displayed at the start of MENU-MAN.
-> To continue with the MENU-MAN program after the display of the shareware
message, press any key.
By registering your use of MENU-MAN, you will be able to use the registration
serial number to suppress the shareware message display.
23